<?php
/* vim: set expandtab sw=4 ts=4 sts=4: */
/**
 * Misc functions used all over the scripts.
 *
 * @version $Id: common.lib.php 11321 2008-06-13 16:26:21Z lem9 $
 */

/**
 * Exponential expression / raise number into power
 *
 * @uses	function_exists()
 * @uses	bcpow()
 * @uses	gmp_pow()
 * @uses	gmp_strval()
 * @uses	pow()
 * @param   number  $base
 * @param   number  $exp
 * @param   string  pow function use, or false for auto-detect
 * @return  mixed  string or float
 */
function PMA_pow($base, $exp, $use_function = false)
{
	static $pow_function = null;

	if ($exp < 0) {
		return false;
	}

	if (null == $pow_function) {
		if (function_exists('bcpow')) {
			// BCMath Arbitrary Precision Mathematics Function
			$pow_function = 'bcpow';
		} elseif (function_exists('gmp_pow')) {
			// GMP Function
			$pow_function = 'gmp_pow';
		} else {
			// PHP function
			$pow_function = 'pow';
		}
	}

	if (! $use_function) {
		$use_function = $pow_function;
	}

	switch ($use_function) {
		case 'bcpow' :
			//bcscale(10);
			$pow = bcpow($base, $exp);
			break;
		case 'gmp_pow' :
			 $pow = gmp_strval(gmp_pow($base, $exp));
			break;
		case 'pow' :
			$base = (float) $base;
			$exp = (int) $exp;
			$pow = pow($base, $exp);
			break;
		default:
			$pow = $use_function($base, $exp);
	}

	return $pow;
}

/**
 * string PMA_getIcon(string $icon)
 *
 * @uses	$GLOBALS['pmaThemeImage']
 * @param   $icon   name of icon
 * @return		  html img tag
 */
function PMA_getIcon($icon, $alternate = '')
{
	if ($GLOBALS['cfg']['PropertiesIconic']) {
		return '<img src="' . $GLOBALS['pmaThemeImage'] . $icon . '"'
			. ' title="' . $alternate . '" alt="' . $alternate . '"'
			. ' class="icon" width="16" height="16" />';
	} else {
		return $alternate;
	}
}

/**
 * Displays the maximum size for an upload
 *
 * @uses	$GLOBALS['strMaximumSize']
 * @uses	PMA_formatByteDown()
 * @uses	sprintf()
 * @param   integer  the size
 *
 * @return  string   the message
 *
 * @access  public
 */
function PMA_displayMaximumUploadSize($max_upload_size)
{
	list($max_size, $max_unit) = PMA_formatByteDown($max_upload_size);
	return '(' . sprintf($GLOBALS['strMaximumSize'], $max_size, $max_unit) . ')';
}

/**
 * Generates a hidden field which should indicate to the browser
 * the maximum size for upload
 *
 * @param   integer  the size
 *
 * @return  string   the INPUT field
 *
 * @access  public
 */
 function PMA_generateHiddenMaxFileSize($max_size)
 {
	 return '<input type="hidden" name="MAX_FILE_SIZE" value="' .$max_size . '" />';
 }

/**
 * Add slashes before "'" and "\" characters so a value containing them can
 * be used in a sql comparison.
 *
 * @uses	str_replace()
 * @param   string   the string to slash
 * @param   boolean  whether the string will be used in a 'LIKE' clause
 *				   (it then requires two more escaped sequences) or not
 * @param   boolean  whether to treat cr/lfs as escape-worthy entities
 *				   (converts \n to \\n, \r to \\r)
 *
 * @param   boolean  whether this function is used as part of the
 *				   "Create PHP code" dialog
 *
 * @return  string   the slashed string
 *
 * @access  public
 */
function PMA_sqlAddslashes($a_string = '', $is_like = false, $crlf = false, $php_code = false)
{
	if ($is_like) {
		$a_string = str_replace('\\', '\\\\\\\\', $a_string);
	} else {
		$a_string = str_replace('\\', '\\\\', $a_string);
	}

	if ($crlf) {
		$a_string = str_replace("\n", '\n', $a_string);
		$a_string = str_replace("\r", '\r', $a_string);
		$a_string = str_replace("\t", '\t', $a_string);
	}

	if ($php_code) {
		$a_string = str_replace('\'', '\\\'', $a_string);
	} else {
		$a_string = str_replace('\'', '\'\'', $a_string);
	}

	return $a_string;
} // end of the 'PMA_sqlAddslashes()' function


/**
 * Add slashes before "_" and "%" characters for using them in MySQL
 * database, table and field names.
 * Note: This function does not escape backslashes!
 *
 * @uses	str_replace()
 * @param   string   the string to escape
 *
 * @return  string   the escaped string
 *
 * @access  public
 */
function PMA_escape_mysql_wildcards($name)
{
	$name = str_replace('_', '\\_', $name);
	$name = str_replace('%', '\\%', $name);

	return $name;
} // end of the 'PMA_escape_mysql_wildcards()' function

/**
 * removes slashes before "_" and "%" characters
 * Note: This function does not unescape backslashes!
 *
 * @uses	str_replace()
 * @param   string   $name  the string to escape
 * @return  string   the escaped string
 * @access  public
 */
function PMA_unescape_mysql_wildcards($name)
{
	$name = str_replace('\\_', '_', $name);
	$name = str_replace('\\%', '%', $name);

	return $name;
} // end of the 'PMA_unescape_mysql_wildcards()' function

/**
 * removes quotes (',",`) from a quoted string
 *
 * checks if the sting is quoted and removes this quotes
 *
 * @uses	str_replace()
 * @uses	substr()
 * @param   string  $quoted_string  string to remove quotes from
 * @param   string  $quote		  type of quote to remove
 * @return  string  unqoted string
 */
function PMA_unQuote($quoted_string, $quote = null)
{
	$quotes = array();

	if (null === $quote) {
		$quotes[] = '`';
		$quotes[] = '"';
		$quotes[] = "'";
	} else {
		$quotes[] = $quote;
	}

	foreach ($quotes as $quote) {
		if (substr($quoted_string, 0, 1) === $quote
		 && substr($quoted_string, -1, 1) === $quote) {
			 $unquoted_string = substr($quoted_string, 1, -1);
			 // replace escaped quotes
			 $unquoted_string = str_replace($quote . $quote, $quote, $unquoted_string);
			 return $unquoted_string;
		 }
	}

	return $quoted_string;
}

/**
 * format sql strings
 *
 * @todo	move into PMA_Sql
 * @uses	PMA_SQP_isError()
 * @uses	PMA_SQP_formatHtml()
 * @uses	PMA_SQP_formatNone()
 * @uses	is_array()
 * @param   mixed	pre-parsed SQL structure
 *
 * @return  string   the formatted sql
 *
 * @global  array	the configuration array
 * @global  boolean  whether the current statement is a multiple one or not
 *
 * @access  public
 *
 * @author  Robin Johnson <robbat2@users.sourceforge.net>
 */
function PMA_formatSql($parsed_sql, $unparsed_sql = '')
{
	global $cfg;

	// Check that we actually have a valid set of parsed data
	// well, not quite
	// first check for the SQL parser having hit an error
	if (PMA_SQP_isError()) {
		return $parsed_sql;
	}
	// then check for an array
	if (!is_array($parsed_sql)) {
		// We don't so just return the input directly
		// This is intended to be used for when the SQL Parser is turned off
		$formatted_sql = '<pre>' . "\n"
						. (($cfg['SQP']['fmtType'] == 'none' && $unparsed_sql != '') ? $unparsed_sql : $parsed_sql) . "\n"
						. '</pre>';
		return $formatted_sql;
	}

	$formatted_sql		= '';

	switch ($cfg['SQP']['fmtType']) {
		case 'none':
			if ($unparsed_sql != '') {
				$formatted_sql = "<pre>\n" . PMA_SQP_formatNone(array('raw' => $unparsed_sql)) . "\n</pre>";
			} else {
				$formatted_sql = PMA_SQP_formatNone($parsed_sql);
			}
			break;
		case 'html':
			$formatted_sql = PMA_SQP_formatHtml($parsed_sql, 'color');
			break;
		case 'text':
			//$formatted_sql = PMA_SQP_formatText($parsed_sql);
			$formatted_sql = PMA_SQP_formatHtml($parsed_sql, 'text');
			break;
		default:
			break;
	} // end switch

	return $formatted_sql;
} // end of the "PMA_formatSql()" function


/**
 * Displays a link to the official MySQL documentation
 *
 * @uses	$cfg['MySQLManualType']
 * @uses	$cfg['MySQLManualBase']
 * @uses	$cfg['ReplaceHelpImg']
 * @uses	$GLOBALS['mysql_4_1_doc_lang']
 * @uses	$GLOBALS['mysql_5_1_doc_lang']
 * @uses	$GLOBALS['mysql_5_0_doc_lang']
 * @uses	$GLOBALS['strDocu']
 * @uses	$GLOBALS['pmaThemeImage']
 * @uses	PMA_MYSQL_INT_VERSION
 * @uses	strtolower()
 * @uses	str_replace()
 * @param string  chapter of "HTML, one page per chapter" documentation
 * @param string  contains name of page/anchor that is being linked
 * @param bool	whether to use big icon (like in left frame)
 *
 * @return  string  the html link
 *
 * @access  public
 */
function PMA_showMySQLDocu($chapter, $link, $big_icon = false)
{
	global $cfg;

	if ($cfg['MySQLManualType'] == 'none' || empty($cfg['MySQLManualBase'])) {
		return '';
	}

	// Fixup for newly used names:
	$chapter = str_replace('_', '-', strtolower($chapter));
	$link = str_replace('_', '-', strtolower($link));

	switch ($cfg['MySQLManualType']) {
		case 'chapters':
			if (empty($chapter)) {
				$chapter = 'index';
			}
			$url = $cfg['MySQLManualBase'] . '/' . $chapter . '.html#' . $link;
			break;
		case 'big':
			$url = $cfg['MySQLManualBase'] . '#' . $link;
			break;
		case 'searchable':
			if (empty($link)) {
				$link = 'index';
			}
			$url = $cfg['MySQLManualBase'] . '/' . $link . '.html';
			break;
		case 'viewable':
		default:
			if (empty($link)) {
				$link = 'index';
			}
			$mysql = '5.0';
			$lang = 'en';
			if (defined('PMA_MYSQL_INT_VERSION')) {
				if (PMA_MYSQL_INT_VERSION < 50000) {
					$mysql = '4.1';
					if (!empty($GLOBALS['mysql_4_1_doc_lang'])) {
						$lang = $GLOBALS['mysql_4_1_doc_lang'];
					}
				} elseif (PMA_MYSQL_INT_VERSION >= 50100) {
					$mysql = '5.1';
					if (!empty($GLOBALS['mysql_5_1_doc_lang'])) {
						$lang = $GLOBALS['mysql_5_1_doc_lang'];
					}
				} elseif (PMA_MYSQL_INT_VERSION >= 50000) {
					$mysql = '5.0';
					if (!empty($GLOBALS['mysql_5_0_doc_lang'])) {
						$lang = $GLOBALS['mysql_5_0_doc_lang'];
					}
				}
			}
			$url = $cfg['MySQLManualBase'] . '/' . $mysql . '/' . $lang . '/' . $link . '.html';
			break;
	}

	if ($big_icon) {
		return '<a href="' . $url . '" target="mysql_doc"><img class="icon" src="' . $GLOBALS['pmaThemeImage'] . 'b_sqlhelp.png" width="16" height="16" alt="' . $GLOBALS['strDocu'] . '" title="' . $GLOBALS['strDocu'] . '" /></a>';
	} elseif ($GLOBALS['cfg']['ReplaceHelpImg']) {
		return '<a href="' . $url . '" target="mysql_doc"><img class="icon" src="' . $GLOBALS['pmaThemeImage'] . 'b_help.png" width="11" height="11" alt="' . $GLOBALS['strDocu'] . '" title="' . $GLOBALS['strDocu'] . '" /></a>';
	} else {
		return '[<a href="' . $url . '" target="mysql_doc">' . $GLOBALS['strDocu'] . '</a>]';
	}
} // end of the 'PMA_showMySQLDocu()' function

/**
 * Displays a hint icon, on mouse over show the hint
 *
 * @uses	$GLOBALS['pmaThemeImage']
 * @uses	PMA_jsFormat()
 * @param   string   the error message
 *
 * @access  public
 */
function PMA_showHint($hint_message)
{
	//return '<img class="lightbulb" src="' . $GLOBALS['pmaThemeImage'] . 'b_tipp.png" width="16" height="16" border="0" alt="' . $hint_message . '" title="' . $hint_message . '" align="middle" onclick="alert(\'' . PMA_jsFormat($hint_message, false) . '\');" />';
	return '<img class="lightbulb" src="' . $GLOBALS['pmaThemeImage']
		. 'b_tipp.png" width="16" height="16" alt="Tip" title="Tip" onmouseover="pmaTooltip(\''
		.  PMA_jsFormat($hint_message, false) . '\'); return false;" onmouseout="swapTooltip(\'default\'); return false;" />';
}

/**
 * Displays a MySQL error message in the right frame.
 *
 * @uses	footer.inc.php
 * @uses	header.inc.php
 * @uses	$GLOBALS['sql_query']
 * @uses	$GLOBALS['strError']
 * @uses	$GLOBALS['strSQLQuery']
 * @uses	$GLOBALS['pmaThemeImage']
 * @uses	$GLOBALS['strEdit']
 * @uses	$GLOBALS['strMySQLSaid']
 * @uses	$GLOBALS['cfg']['PropertiesIconic'] 
 * @uses	$GLOBALS['cfg']['MaxCharactersInDisplayedSQL'] 
 * @uses	PMA_backquote()
 * @uses	PMA_DBI_getError()
 * @uses	PMA_formatSql()
 * @uses	PMA_generate_common_hidden_inputs()
 * @uses	PMA_generate_common_url()
 * @uses	PMA_showMySQLDocu()
 * @uses	PMA_sqlAddslashes()
 * @uses	PMA_SQP_isError()
 * @uses	PMA_SQP_parse()
 * @uses	PMA_SQP_getErrorString()
 * @uses	strtolower()
 * @uses	urlencode()
 * @uses	str_replace()
 * @uses	nl2br()
 * @uses	substr()
 * @uses	preg_replace()
 * @uses	preg_match()
 * @uses	explode()
 * @uses	implode()
 * @uses	is_array()
 * @uses	function_exists()
 * @uses	htmlspecialchars()
 * @uses	trim()
 * @uses	strstr()
 * @param   string   the error message
 * @param   string   the sql query that failed
 * @param   boolean  whether to show a "modify" link or not
 * @param   string   the "back" link url (full path is not required)
 * @param   boolean  EXIT the page?
 *
 * @global  string	the curent table
 * @global  string	the current db
 *
 * @access  public
 */
function PMA_mysqlDie($error_message = '', $the_query = '',
						$is_modify_link = true, $back_url = '', $exit = true)
{
	global $table, $db;

	/**
	 * start http output, display html headers
	 */
	require_once './libraries/header.inc.php';

	if (!$error_message) {
		$error_message = PMA_DBI_getError();
	}
	if (!$the_query && !empty($GLOBALS['sql_query'])) {
		$the_query = $GLOBALS['sql_query'];
	}

	// --- Added to solve bug #641765
	// Robbat2 - 12 January 2003, 9:46PM
	// Revised, Robbat2 - 13 January 2003, 2:59PM
	if (!function_exists('PMA_SQP_isError') || PMA_SQP_isError()) {
		$formatted_sql = htmlspecialchars($the_query);
	} elseif (empty($the_query) || trim($the_query) == '') {
		$formatted_sql = '';
	} else {
		if (strlen($the_query) > $GLOBALS['cfg']['MaxCharactersInDisplayedSQL']) {
			$formatted_sql = substr($the_query, 0, $GLOBALS['cfg']['MaxCharactersInDisplayedSQL']) . '[...]';
		} else {
			$formatted_sql = PMA_formatSql(PMA_SQP_parse($the_query), $the_query);
		}
	}
	// ---
	echo "\n" . '<!-- PMA-SQL-ERROR -->' . "\n";
	echo '	<div class="error"><h1>' . $GLOBALS['strError'] . '</h1>' . "\n";
	// if the config password is wrong, or the MySQL server does not
	// respond, do not show the query that would reveal the
	// username/password
	if (!empty($the_query) && !strstr($the_query, 'connect')) {
		// --- Added to solve bug #641765
		// Robbat2 - 12 January 2003, 9:46PM
		// Revised, Robbat2 - 13 January 2003, 2:59PM
		if (function_exists('PMA_SQP_isError') && PMA_SQP_isError()) {
			echo PMA_SQP_getErrorString() . "\n";
			echo '<br />' . "\n";
		}
		// ---
		// modified to show me the help on sql errors (Michael Keck)
		echo '	<p><strong>' . $GLOBALS['strSQLQuery'] . ':</strong>' . "\n";
		if (strstr(strtolower($formatted_sql), 'select')) { // please show me help to the error on select
			echo PMA_showMySQLDocu('SQL-Syntax', 'SELECT');
		}
		if ($is_modify_link && strlen($db)) {
			if (strlen($table)) {
				$doedit_goto = '<a href="tbl_sql.php?' . PMA_generate_common_url($db, $table) . '&amp;sql_query=' . urlencode($the_query) . '&amp;show_query=1">';
			} else {
				$doedit_goto = '<a href="db_sql.php?' . PMA_generate_common_url($db) . '&amp;sql_query=' . urlencode($the_query) . '&amp;show_query=1">';
			}
			if ($GLOBALS['cfg']['PropertiesIconic']) {
				echo $doedit_goto
				   . '<img class="icon" src=" '. $GLOBALS['pmaThemeImage'] . 'b_edit.png" width="16" height="16" alt="' . $GLOBALS['strEdit'] .'" />'
				   . '</a>';
			} else {
				echo '	['
				   . $doedit_goto . $GLOBALS['strEdit'] . '</a>'
				   . ']' . "\n";
			}
		} // end if
		echo '	</p>' . "\n"
			.'	<p>' . "\n"
			.'		' . $formatted_sql . "\n"
			.'	</p>' . "\n";
	} // end if

	$tmp_mysql_error = ''; // for saving the original $error_message
	if (!empty($error_message)) {
		$tmp_mysql_error = strtolower($error_message); // save the original $error_message
		$error_message = htmlspecialchars($error_message);
		$error_message = preg_replace("@((\015\012)|(\015)|(\012)){3,}@", "\n\n", $error_message);
	}
	// modified to show me the help on error-returns (Michael Keck)
	// (now error-messages-server)
	echo '<p>' . "\n"
			. '	<strong>' . $GLOBALS['strMySQLSaid'] . '</strong>'
			. PMA_showMySQLDocu('Error-messages-server', 'Error-messages-server')
			. "\n"
			. '</p>' . "\n";

	// The error message will be displayed within a CODE segment.
	// To preserve original formatting, but allow wordwrapping, we do a couple of replacements

	// Replace all non-single blanks with their HTML-counterpart
	$error_message = str_replace('  ', '&nbsp;&nbsp;', $error_message);
	// Replace TAB-characters with their HTML-counterpart
	$error_message = str_replace("\t", '&nbsp;&nbsp;&nbsp;&nbsp;', $error_message);
	// Replace linebreaks
	$error_message = nl2br($error_message);

	echo '<code>' . "\n"
		. $error_message . "\n"
		. '</code><br />' . "\n";
	echo '</div>';
	echo '<fieldset class="tblFooters">';

	if (!empty($back_url) && $exit) {
		$goto_back_url='<a href="' . (strstr($back_url, '?') ? $back_url . '&amp;no_history=true' : $back_url . '?no_history=true') . '">';
		echo '[ ' . $goto_back_url . $GLOBALS['strBack'] . '</a> ]';
	}
	echo '	</fieldset>' . "\n\n";
	if ($exit) {
		/**
		 * display footer and exit
		 */
		require_once './libraries/footer.inc.php';
	}
} // end of the 'PMA_mysqlDie()' function

/**
 * Returns a string formatted with CONVERT ... USING
 * if MySQL supports it
 *
 * @uses	PMA_MYSQL_INT_VERSION
 * @uses	$GLOBALS['collation_connection']
 * @uses	explode()
 * @param   string  the string itself
 * @param   string  the mode: quoted or unquoted (this one by default)
 *
 * @return  the formatted string
 *
 * @access  private
 */
function PMA_convert_using($string, $mode='unquoted', $force_utf8 = false)
{
	if ($mode == 'quoted') {
		$possible_quote = "'";
	} else {
		$possible_quote = "";
	}

	if (PMA_MYSQL_INT_VERSION >= 40100) {
		if ($force_utf8) {
			$charset = 'utf8';
			$collate = ' COLLATE utf8_bin';
		} else {
			list($charset) = explode('_', $GLOBALS['collation_connection']);
			$collate = '';
		}
		$converted_string = "CONVERT(" . $possible_quote . $string . $possible_quote . " USING " . $charset . ")" . $collate;
	} else {
		$converted_string = $possible_quote . $string . $possible_quote;
	}
	return $converted_string;
} // end function

/**
 * Send HTTP header, taking IIS limits into account (600 seems ok)
 *
 * @uses	PMA_IS_IIS
 * @uses	PMA_COMING_FROM_COOKIE_LOGIN
 * @uses	PMA_get_arg_separator()
 * @uses	SID
 * @uses	strlen()
 * @uses	strpos()
 * @uses	header()
 * @uses	session_write_close()
 * @uses	headers_sent()
 * @uses	function_exists()
 * @uses	debug_print_backtrace()
 * @uses	trigger_error()
 * @uses	defined()
 * @param   string   $uri the header to send
 * @return  boolean  always true
 */
function PMA_sendHeaderLocation($uri)
{
	if (PMA_IS_IIS && strlen($uri) > 600) {

		echo '<html><head><title>- - -</title>' . "\n";
		echo '<meta http-equiv="expires" content="0">' . "\n";
		echo '<meta http-equiv="Pragma" content="no-cache">' . "\n";
		echo '<meta http-equiv="Cache-Control" content="no-cache">' . "\n";
		echo '<meta http-equiv="Refresh" content="0;url=' .$uri . '">' . "\n";
		echo '<script type="text/javascript">' . "\n";
		echo '//<![CDATA[' . "\n";
		echo 'setTimeout("window.location = unescape(\'"' . $uri . '"\')", 2000);' . "\n";
		echo '//]]>' . "\n";
		echo '</script>' . "\n";
		echo '</head>' . "\n";
		echo '<body>' . "\n";
		echo '<script type="text/javascript">' . "\n";
		echo '//<![CDATA[' . "\n";
		echo 'document.write(\'<p><a href="' . $uri . '">' . $GLOBALS['strGo'] . '</a></p>\');' . "\n";
		echo '//]]>' . "\n";
		echo '</script></body></html>' . "\n";

	} else {
		if (SID) {
			if (strpos($uri, '?') === false) {
				header('Location: ' . $uri . '?' . SID);
			} else {
				$separator = PMA_get_arg_separator();
				header('Location: ' . $uri . $separator . SID);
			}
		} else {
			session_write_close();
			if (headers_sent()) {
				if (function_exists('debug_print_backtrace')) {
					echo '<pre>';
					debug_print_backtrace();
					echo '</pre>';
				}
				trigger_error('PMA_sendHeaderLocation called when headers are already sent!', E_USER_ERROR);
			}
			// bug #1523784: IE6 does not like 'Refresh: 0', it
			// results in a blank page
			// but we need it when coming from the cookie login panel)
			if (PMA_IS_IIS && defined('PMA_COMING_FROM_COOKIE_LOGIN')) {
				header('Refresh: 0; ' . $uri);
			} else {
				header('Location: ' . $uri);
			}
		}
	}
}

/**
 * returns array with tables of given db with extended information and grouped
 *
 * @uses	$cfg['LeftFrameTableSeparator']
 * @uses	$cfg['LeftFrameTableLevel']
 * @uses	$cfg['ShowTooltipAliasTB']
 * @uses	$cfg['NaturalOrder']
 * @uses	PMA_backquote()
 * @uses	count()
 * @uses	array_merge
 * @uses	uksort()
 * @uses	strstr()
 * @uses	explode()
 * @param   string  $db	 name of db
 * @param   string  $tables name of tables
 * return   array   (recursive) grouped table list
 */
function PMA_getTableList($db, $tables = null, $limit_offset = 0, $limit_count = false)
{
	$sep = $GLOBALS['cfg']['LeftFrameTableSeparator'];

	if (null === $tables) {
		$tables = PMA_DBI_get_tables_full($db, false, false, null, $limit_offset, $limit_count);
		if ($GLOBALS['cfg']['NaturalOrder']) {
			uksort($tables, 'strnatcasecmp');
		}
	}

	if (count($tables) < 1) {
		return $tables;
	}

	$default = array(
		'Name'	  => '',
		'Rows'	  => 0,
		'Comment'   => '',
		'disp_name' => '',
	);

	$table_groups = array();

	foreach ($tables as $table_name => $table) {

		// check for correct row count
		if (null === $table['Rows']) {
			// Do not check exact row count here,
			// if row count is invalid possibly the table is defect
			// and this would break left frame;
			// but we can check row count if this is a view,
			// since PMA_Table::countRecords() returns a limited row count
			// in this case.

			// set this because PMA_Table::countRecords() can use it
			$tbl_is_view = PMA_Table::isView($db, $table['Name']);

			if ($tbl_is_view) {
				$table['Rows'] = PMA_Table::countRecords($db, $table['Name'],
					$return = true);
			}
		}

		// in $group we save the reference to the place in $table_groups
		// where to store the table info
		if ($GLOBALS['cfg']['LeftFrameDBTree']
			&& $sep && strstr($table_name, $sep))
		{
			$parts = explode($sep, $table_name);

			$group =& $table_groups;
			$i = 0;
			$group_name_full = '';
			while ($i < count($parts) - 1
			  && $i < $GLOBALS['cfg']['LeftFrameTableLevel']) {
				$group_name = $parts[$i] . $sep;
				$group_name_full .= $group_name;

				if (!isset($group[$group_name])) {
					$group[$group_name] = array();
					$group[$group_name]['is' . $sep . 'group'] = true;
					$group[$group_name]['tab' . $sep . 'count'] = 1;
					$group[$group_name]['tab' . $sep . 'group'] = $group_name_full;
				} elseif (!isset($group[$group_name]['is' . $sep . 'group'])) {
					$table = $group[$group_name];
					$group[$group_name] = array();
					$group[$group_name][$group_name] = $table;
					unset($table);
					$group[$group_name]['is' . $sep . 'group'] = true;
					$group[$group_name]['tab' . $sep . 'count'] = 1;
					$group[$group_name]['tab' . $sep . 'group'] = $group_name_full;
				} else {
					$group[$group_name]['tab' . $sep . 'count']++;
				}
				$group =& $group[$group_name];
				$i++;
			}
		} else {
			if (!isset($table_groups[$table_name])) {
				$table_groups[$table_name] = array();
			}
			$group =& $table_groups;
		}


		if ($GLOBALS['cfg']['ShowTooltipAliasTB']
		  && $GLOBALS['cfg']['ShowTooltipAliasTB'] !== 'nested') {
			// switch tooltip and name
			$table['Comment'] = $table['Name'];
			$table['disp_name'] = $table['Comment'];
		} else {
			$table['disp_name'] = $table['Name'];
		}

		$group[$table_name] = array_merge($default, $table);
	}

	return $table_groups;
}

/* ----------------------- Set of misc functions ----------------------- */


/**
 * Adds backquotes on both sides of a database, table or field name.
 * and escapes backquotes inside the name with another backquote
 *
 * example:
 * <code>
 * echo PMA_backquote('owner`s db'); // `owner``s db`
 *
 * </code>
 *
 * @uses	PMA_backquote()
 * @uses	is_array()
 * @uses	strlen()
 * @uses	str_replace()
 * @param   mixed	$a_name	the database, table or field name to "backquote"
 *							  or array of it
 * @param   boolean  $do_it	 a flag to bypass this function (used by dump
 *							  functions)
 * @return  mixed	the "backquoted" database, table or field name if the
 *				   current MySQL release is >= 3.23.6, the original one
 *				   else
 * @access  public
 */
function PMA_backquote($a_name, $do_it = true)
{
	if (! $do_it) {
		return $a_name;
	}

	if (is_array($a_name)) {
		 $result = array();
		 foreach ($a_name as $key => $val) {
			 $result[$key] = PMA_backquote($val);
		 }
		 return $result;
	}

	// '0' is also empty for php :-(
	if (strlen($a_name) && $a_name !== '*') {
		return '`' . str_replace('`', '``', $a_name) . '`';
	} else {
		return $a_name;
	}
} // end of the 'PMA_backquote()' function


/**
 * Defines the <CR><LF> value depending on the user OS.
 *
 * @uses	PMA_USR_OS
 * @return  string   the <CR><LF> value to use
 *
 * @access  public
 */
function PMA_whichCrlf()
{
	$the_crlf = "\n";

	// The 'PMA_USR_OS' constant is defined in "./libraries/Config.class.php"
	// Win case
	if (PMA_USR_OS == 'Win') {
		$the_crlf = "\r\n";
	}
	// Others
	else {
		$the_crlf = "\n";
	}

	return $the_crlf;
} // end of the 'PMA_whichCrlf()' function

/**
 * Reloads navigation if needed.
 *
 * @uses	$GLOBALS['reload']
 * @uses	$GLOBALS['db']
 * @uses	PMA_generate_common_url()
 * @global  array  configuration
 *
 * @access  public
 */
function PMA_reloadNavigation()
{
	global $cfg;

	// Reloads the navigation frame via JavaScript if required
	if (isset($GLOBALS['reload']) && $GLOBALS['reload']) {
		// one of the reasons for a reload is when a table is dropped
		// in this case, get rid of the table limit offset, otherwise
		// we have a problem when dropping a table on the last page
		// and the offset becomes greater than the total number of tables
		unset($_SESSION['userconf']['table_limit_offset']);
		echo "\n";
		$reload_url = './navigation.php?' . PMA_generate_common_url($GLOBALS['db'], '', '&');
		?>
<script type="text/javascript">
//<![CDATA[
if (typeof(window.parent) != 'undefined'
	&& typeof(window.parent.frame_navigation) != 'undefined') {
	window.parent.goTo('<?php echo $reload_url; ?>');
}
//]]>
</script>
		<?php
		unset($GLOBALS['reload']);
	}
}

/**
 * displays the message and the query
 * usually the message is the result of the query executed
 *
 * @param   string  $message	the message to display
 * @param   string  $sql_query  the query to display
 * @global  array   the configuration array
 * @uses	$cfg
 * @access  public
 */
function PMA_showMessage($message, $sql_query = null)
{
	global $cfg;
	$query_too_big = false;

	if (null === $sql_query) {
		if (! empty($GLOBALS['display_query'])) {
			$sql_query = $GLOBALS['display_query'];
		} elseif ($cfg['SQP']['fmtType'] == 'none' && ! empty($GLOBALS['unparsed_sql'])) {
			$sql_query = $GLOBALS['unparsed_sql'];
		} elseif (! empty($GLOBALS['sql_query'])) {
			$sql_query = $GLOBALS['sql_query'];
		} else {
			$sql_query = '';
		}
	}

	// Corrects the tooltip text via JS if required
	// @todo this is REALLY the wrong place to do this - very unexpected here
	if (strlen($GLOBALS['table']) && $cfg['ShowTooltip']) {
		$result = PMA_DBI_try_query('SHOW TABLE STATUS FROM ' . PMA_backquote($GLOBALS['db']) . ' LIKE \'' . PMA_sqlAddslashes($GLOBALS['table'], true) . '\'');
		if ($result) {
			$tbl_status = PMA_DBI_fetch_assoc($result);
			$tooltip	= (empty($tbl_status['Comment']))
						? ''
						: $tbl_status['Comment'] . ' ';
			$tooltip .= '(' . PMA_formatNumber($tbl_status['Rows'], 0) . ' ' . $GLOBALS['strRows'] . ')';
			PMA_DBI_free_result($result);
			$uni_tbl = PMA_jsFormat($GLOBALS['db'] . '.' . $GLOBALS['table'], false);
			echo "\n";
			echo '<script type="text/javascript">' . "\n";
			echo '//<![CDATA[' . "\n";
			echo "window.parent.updateTableTitle('" . $uni_tbl . "', '" . PMA_jsFormat($tooltip, false) . "');" . "\n";
			echo '//]]>' . "\n";
			echo '</script>' . "\n";
		} // end if
	} // end if ... elseif

	// Checks if the table needs to be repaired after a TRUNCATE query.
	// @todo what about $GLOBALS['display_query']???
	// @todo this is REALLY the wrong place to do this - very unexpected here
	if (strlen($GLOBALS['table'])
	 && $GLOBALS['sql_query'] == 'TRUNCATE TABLE ' . PMA_backquote($GLOBALS['table'])) {
		if (!isset($tbl_status)) {
			$result = @PMA_DBI_try_query('SHOW TABLE STATUS FROM ' . PMA_backquote($GLOBALS['db']) . ' LIKE \'' . PMA_sqlAddslashes($GLOBALS['table'], true) . '\'');
			if ($result) {
				$tbl_status = PMA_DBI_fetch_assoc($result);
				PMA_DBI_free_result($result);
			}
		}
		if (isset($tbl_status) && (int) $tbl_status['Index_length'] > 1024) {
			PMA_DBI_try_query('REPAIR TABLE ' . PMA_backquote($GLOBALS['table']));
		}
	}
	unset($tbl_status);
	echo '<br />' . "\n";

	echo '<div align="' . $GLOBALS['cell_align_left'] . '">' . "\n";
	if (!empty($GLOBALS['show_error_header'])) {
		echo '<div class="error">' . "\n";
		echo '<h1>' . $GLOBALS['strError'] . '</h1>' . "\n";
	}

	echo '<div class="notice">';
	echo PMA_sanitize($message);
	if (isset($GLOBALS['special_message'])) {
		echo PMA_sanitize($GLOBALS['special_message']);
		unset($GLOBALS['special_message']);
	}
	echo '</div>';

	if (!empty($GLOBALS['show_error_header'])) {
		echo '</div>';
	}

	if ($cfg['ShowSQL'] == true && ! empty($sql_query)) {
		// Basic url query part
		$url_qpart = '?' . PMA_generate_common_url($GLOBALS['db'], $GLOBALS['table']);

		// Html format the query to be displayed
		// The nl2br function isn't used because its result isn't a valid
		// xhtml1.0 statement before php4.0.5 ("<br>" and not "<br />")
		// If we want to show some sql code it is easiest to create it here
		 /* SQL-Parser-Analyzer */

		if (!empty($GLOBALS['show_as_php'])) {
			$new_line = '\'<br />' . "\n" . '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;. \' ';
		}
		if (isset($new_line)) {
			 /* SQL-Parser-Analyzer */
			$query_base = PMA_sqlAddslashes(htmlspecialchars($sql_query), false, false, true);
			 /* SQL-Parser-Analyzer */
			$query_base = preg_replace("@((\015\012)|(\015)|(\012))+@", $new_line, $query_base);
		} else {
			$query_base = $sql_query;
		}

		if (strlen($query_base) > $cfg['MaxCharactersInDisplayedSQL']) {
			$query_too_big = true; 
			$query_base = nl2br(htmlspecialchars($sql_query));
			unset($GLOBALS['parsed_sql']);
		}

		// Parse SQL if needed
		// (here, use "! empty" because when deleting a bookmark,
		// $GLOBALS['parsed_sql'] is set but empty
		if (! empty($GLOBALS['parsed_sql']) && $query_base == $GLOBALS['parsed_sql']['raw']) {
			$parsed_sql = $GLOBALS['parsed_sql'];
		} else {
			// when the query is large (for example an INSERT of binary
			// data), the parser chokes; so avoid parsing the query
			if (! $query_too_big) {
				$parsed_sql = PMA_SQP_parse($query_base);
			}
		}

		// Analyze it
		if (isset($parsed_sql)) {
			$analyzed_display_query = PMA_SQP_analyze($parsed_sql);
		}

		// Here we append the LIMIT added for navigation, to
		// enable its display. Adding it higher in the code
		// to $sql_query would create a problem when
		// using the Refresh or Edit links.

		// Only append it on SELECTs.

		/**
		 * @todo what would be the best to do when someone hits Refresh:
		 * use the current LIMITs ?
		 */

		if (isset($analyzed_display_query[0]['queryflags']['select_from'])
		 && isset($GLOBALS['sql_limit_to_append'])) {
			$query_base  = $analyzed_display_query[0]['section_before_limit'] . "\n" . $GLOBALS['sql_limit_to_append'] . $analyzed_display_query[0]['section_after_limit'];
			// Need to reparse query
			$parsed_sql = PMA_SQP_parse($query_base);
		}

		if (!empty($GLOBALS['show_as_php'])) {
			$query_base = '$sql  = \'' . $query_base;
		} elseif (!empty($GLOBALS['validatequery'])) {
			$query_base = PMA_validateSQL($query_base);
		} else {
			if (isset($parsed_sql)) {
				$query_base = PMA_formatSql($parsed_sql, $query_base);
			}
		}

		// Prepares links that may be displayed to edit/explain the query
		// (don't go to default pages, we must go to the page
		// where the query box is available)

		$edit_target = strlen($GLOBALS['db']) ? (strlen($GLOBALS['table']) ? 'tbl_sql.php' : 'db_sql.php') : 'server_sql.php';

		if (isset($cfg['SQLQuery']['Edit'])
			&& ($cfg['SQLQuery']['Edit'] == true)
			&& (!empty($edit_target))
			&& ! $query_too_big) {

			if ($cfg['EditInWindow'] == true) {
				$onclick = 'window.parent.focus_querywindow(\'' . PMA_jsFormat($sql_query, false) . '\'); return false;';
			} else {
				$onclick = '';
			}

			$edit_link = $edit_target
					   . $url_qpart
					   . '&amp;sql_query=' . urlencode($sql_query)
					   . '&amp;show_query=1#querybox';
			$edit_link = ' [' . PMA_linkOrButton($edit_link, $GLOBALS['strEdit'], array('onclick' => $onclick)) . ']';
		} else {
			$edit_link = '';
		}

		// Want to have the query explained (Mike Beck 2002-05-22)
		// but only explain a SELECT (that has not been explained)
		/* SQL-Parser-Analyzer */
		if (isset($cfg['SQLQuery']['Explain'])
			&& $cfg['SQLQuery']['Explain'] == true
			&& ! $query_too_big) {

			// Detect if we are validating as well
			// To preserve the validate uRL data
			if (!empty($GLOBALS['validatequery'])) {
				$explain_link_validate = '&amp;validatequery=1';
			} else {
				$explain_link_validate = '';
			}

			$explain_link = 'import.php'
						  . $url_qpart
						  . $explain_link_validate
						  . '&amp;sql_query=';

			if (preg_match('@^SELECT[[:space:]]+@i', $sql_query)) {
				$explain_link .= urlencode('EXPLAIN ' . $sql_query);
				$message = $GLOBALS['strExplain'];
			} elseif (preg_match('@^EXPLAIN[[:space:]]+SELECT[[:space:]]+@i', $sql_query)) {
				$explain_link .= urlencode(substr($sql_query, 8));
				$message = $GLOBALS['strNoExplain'];
			} else {
				$explain_link = '';
			}
			if (!empty($explain_link)) {
				$explain_link = ' [' . PMA_linkOrButton($explain_link, $message) . ']';
			}
		} else {
			$explain_link = '';
		} //show explain

		// Also we would like to get the SQL formed in some nice
		// php-code (Mike Beck 2002-05-22)
		if (isset($cfg['SQLQuery']['ShowAsPHP'])
			&& $cfg['SQLQuery']['ShowAsPHP'] == true
			&& ! $query_too_big) {
			$php_link = 'import.php'
					  . $url_qpart
					  . '&amp;show_query=1'
					  . '&amp;sql_query=' . urlencode($sql_query)
					  . '&amp;show_as_php=';

			if (!empty($GLOBALS['show_as_php'])) {
				$php_link .= '0';
				$message = $GLOBALS['strNoPhp'];
			} else {
				$php_link .= '1';
				$message = $GLOBALS['strPhp'];
			}
			$php_link = ' [' . PMA_linkOrButton($php_link, $message) . ']';

			if (isset($GLOBALS['show_as_php'])) {
				$runquery_link
					 = 'import.php'
					 . $url_qpart
					 . '&amp;show_query=1'
					 . '&amp;sql_query=' . urlencode($sql_query);
				$php_link .= ' [' . PMA_linkOrButton($runquery_link, $GLOBALS['strRunQuery']) . ']';
			}

		} else {
			$php_link = '';
		} //show as php

		// Refresh query
		if (isset($cfg['SQLQuery']['Refresh'])
			&& $cfg['SQLQuery']['Refresh']
			&& preg_match('@^(SELECT|SHOW)[[:space:]]+@i', $sql_query)) {

			$refresh_link = 'import.php'
					  . $url_qpart
					  . '&amp;show_query=1'
					  . '&amp;sql_query=' . urlencode($sql_query);
			$refresh_link = ' [' . PMA_linkOrButton($refresh_link, $GLOBALS['strRefresh']) . ']';
		} else {
			$refresh_link = '';
		} //show as php

		if (isset($cfg['SQLValidator']['use'])
			&& $cfg['SQLValidator']['use'] == true
			&& isset($cfg['SQLQuery']['Validate'])
			&& $cfg['SQLQuery']['Validate'] == true) {
			$validate_link = 'import.php'
						   . $url_qpart
						   . '&amp;show_query=1'
						   . '&amp;sql_query=' . urlencode($sql_query)
						   . '&amp;validatequery=';
			if (!empty($GLOBALS['validatequery'])) {
				$validate_link .= '0';
				$validate_message = $GLOBALS['strNoValidateSQL'] ;
			} else {
				$validate_link .= '1';
				$validate_message = $GLOBALS['strValidateSQL'] ;
			}
			$validate_link = ' [' . PMA_linkOrButton($validate_link, $validate_message) . ']';
		} else {
			$validate_link = '';
		} //validator

		// why this?
		//unset($sql_query);

		// Displays the message
		echo '<fieldset class="">' . "\n";
		echo '	<legend>' . $GLOBALS['strSQLQuery'] . ':</legend>';
		echo '	<div>';
		// when uploading a 700 Kio binary file into a LONGBLOB,
		// I get a white page, strlen($query_base) is 2 x 700 Kio
		// so put a hard limit here (let's say 1000)
		if ($query_too_big) {
			echo '	' . substr($query_base, 0, $cfg['MaxCharactersInDisplayedSQL']) . '[...]';
		} else {
			echo '	' . $query_base;
		}

		//Clean up the end of the PHP
		if (!empty($GLOBALS['show_as_php'])) {
			echo '\';';
		}
		echo '	</div>';
		echo '</fieldset>' . "\n";

		if (!empty($edit_target)) {
			echo '<fieldset class="tblFooters">';
			// avoid displaying a Profiling checkbox that could
			// be checked, which would reexecute an INSERT, for example
			if (! empty($refresh_link)) {
				PMA_profilingCheckbox($sql_query);
			}
			echo $edit_link . $explain_link . $php_link . $refresh_link . $validate_link;
			echo '</fieldset>';
		}
	}
	echo '</div><br />' . "\n";
} // end of the 'PMA_showMessage()' function


/**
 * Verifies if current MySQL server supports profiling 
 *
 * @access  public
 * @return  boolean whether profiling is supported 
 *
 * @author   Marc Delisle 
 */
function PMA_profilingSupported() {
	// 5.0.37 has profiling but for example, 5.1.20 does not
	// (avoid a trip to the server for MySQL before 5.0.37)
	// and do not set a constant as we might be switching servers
	if (defined('PMA_MYSQL_INT_VERSION') && PMA_MYSQL_INT_VERSION >= 50037 && PMA_DBI_fetch_value("SHOW VARIABLES LIKE 'profiling'")) {
		return true;
	} else {
		return false;
	}
}

/**
 * Displays a form with the Profiling checkbox 
 *
 * @param   string  $sql_query
 * @access  public
 *
 * @author   Marc Delisle 
 */
function PMA_profilingCheckbox($sql_query) {
	if (PMA_profilingSupported()) {
		echo '<form action="sql.php" method="post">' . "\n";
		echo PMA_generate_common_hidden_inputs($GLOBALS['db'], $GLOBALS['table']);
		echo '<input type="hidden" name="sql_query" value="' . htmlspecialchars($sql_query) . '" />' . "\n";
		echo '<input type="hidden" name="profiling_form" value="1" />' . "\n";
		echo '<input type="checkbox" name="profiling" id="profiling"' . (isset($_SESSION['profiling']) ? ' checked="checked"' : '') . ' onclick="this.form.submit();" /><label for="profiling">' . $GLOBALS['strProfiling'] . '</label>' . "\n";
		echo '<noscript><input type="submit" value="' . $GLOBALS['strGo'] . '" /></noscript>' . "\n";
		echo '</form>' . "\n";
	}
}

/**
 * Displays the results of SHOW PROFILE 
 *
 * @param	array   the results 
 * @access  public
 *
 * @author   Marc Delisle 
 */
function PMA_profilingResults($profiling_results) {
	echo '<fieldset><legend>' . $GLOBALS['strProfiling'] . '</legend>' . "\n";
	echo '<table>' . "\n";
	echo ' <tr>' .  "\n";
	echo '  <th>' . $GLOBALS['strStatus'] . '</th>' . "\n";
	echo '  <th>' . $GLOBALS['strTime'] . '</th>' . "\n";
	echo ' </tr>' .  "\n";

	foreach($profiling_results as $one_result) {
		echo ' <tr>' .  "\n";
		echo '<td>' . $one_result['Status'] . '</td>' .  "\n";
		echo '<td>' . $one_result['Duration'] . '</td>' .  "\n";
	}
	echo '</table>' . "\n";
	echo '</fieldset>' . "\n";
}

/**
 * Formats $value to byte view
 *
 * @param	double   the value to format
 * @param	integer  the sensitiveness
 * @param	integer  the number of decimals to retain
 *
 * @return   array	the formatted value and its unit
 *
 * @access  public
 *
 * @author   staybyte
 * @version  1.2 - 18 July 2002
 */
function PMA_formatByteDown($value, $limes = 6, $comma = 0)
{
	$dh		   = PMA_pow(10, $comma);
	$li		   = PMA_pow(10, $limes);
	$return_value = $value;
	$unit		 = $GLOBALS['byteUnits'][0];

	for ($d = 6, $ex = 15; $d >= 1; $d--, $ex-=3) {
		if (isset($GLOBALS['byteUnits'][$d]) && $value >= $li * PMA_pow(10, $ex)) {
			// use 1024.0 to avoid integer overflow on 64-bit machines
			$value = round($value / (PMA_pow(1024, $d) / $dh)) /$dh;
			$unit = $GLOBALS['byteUnits'][$d];
			break 1;
		} // end if
	} // end for

	if ($unit != $GLOBALS['byteUnits'][0]) {
		// if the unit is not bytes (as represented in current language)
		// reformat with max length of 5
		// 4th parameter=true means do not reformat if value < 1
		$return_value = PMA_formatNumber($value, 5, $comma, true);
	} else {
		// do not reformat, just handle the locale
		$return_value = PMA_formatNumber($value, 0);
	}

	return array($return_value, $unit);
} // end of the 'PMA_formatByteDown' function

/**
 * Formats $value to the given length and appends SI prefixes
 * $comma is not substracted from the length
 * with a $length of 0 no truncation occurs, number is only formated
 * to the current locale
 *
 * examples:
 * <code>
 * echo PMA_formatNumber(123456789, 6);	 // 123,457 k
 * echo PMA_formatNumber(-123456789, 4, 2); //	-123.46 M
 * echo PMA_formatNumber(-0.003, 6);		//	  -3 m
 * echo PMA_formatNumber(0.003, 3, 3);	  //	   0.003
 * echo PMA_formatNumber(0.00003, 3, 2);	//	   0.03 m
 * echo PMA_formatNumber(0, 6);			 //	   0
 *
 * </code>
 * @param   double   $value	 the value to format
 * @param   integer  $length	the max length
 * @param   integer  $comma	 the number of decimals to retain
 * @param   boolean  $only_down do not reformat numbers below 1
 *
 * @return  string   the formatted value and its unit
 *
 * @access  public
 *
 * @author  staybyte, sebastian mendel
 * @version 1.1.0 - 2005-10-27
 */
function PMA_formatNumber($value, $length = 3, $comma = 0, $only_down = false)
{
	//number_format is not multibyte safe, str_replace is safe
	if ($length === 0) {
		return str_replace(array(',', '.'),
				array($GLOBALS['number_thousands_separator'], $GLOBALS['number_decimal_separator']),
				number_format($value, $comma));
	}

	// this units needs no translation, ISO
	$units = array(
		-8 => 'y',
		-7 => 'z',
		-6 => 'a',
		-5 => 'f',
		-4 => 'p',
		-3 => 'n',
		-2 => '&micro;',
		-1 => 'm',
		0 => ' ',
		1 => 'k',
		2 => 'M',
		3 => 'G',
		4 => 'T',
		5 => 'P',
		6 => 'E',
		7 => 'Z',
		8 => 'Y'
	);

	// we need at least 3 digits to be displayed
	if (3 > $length + $comma) {
		$length = 3 - $comma;
	}

	// check for negative value to retain sign
	if ($value < 0) {
		$sign = '-';
		$value = abs($value);
	} else {
		$sign = '';
	}

	$dh = PMA_pow(10, $comma);
	$li = PMA_pow(10, $length);
	$unit = $units[0];

	if ($value >= 1) {
		for ($d = 8; $d >= 0; $d--) {
			if (isset($units[$d]) && $value >= $li * PMA_pow(1000, $d-1)) {
				$value = round($value / (PMA_pow(1000, $d) / $dh)) /$dh;
				$unit = $units[$d];
				break 1;
			} // end if
		} // end for
	} elseif (!$only_down && (float) $value !== 0.0) {
		for ($d = -8; $d <= 8; $d++) {
			if (isset($units[$d]) && $value <= $li * PMA_pow(1000, $d-1)) {
				$value = round($value / (PMA_pow(1000, $d) / $dh)) /$dh;
				$unit = $units[$d];
				break 1;
			} // end if
		} // end for
	} // end if ($value >= 1) elseif (!$only_down && (float) $value !== 0.0)

	//number_format is not multibyte safe, str_replace is safe
	$value = str_replace(array(',', '.'),
						 array($GLOBALS['number_thousands_separator'], $GLOBALS['number_decimal_separator']),
						 number_format($value, $comma));

	return $sign . $value . ' ' . $unit;
} // end of the 'PMA_formatNumber' function

/**
 * Extracts ENUM / SET options from a type definition string
 *
 * @param   string   The column type definition
 *
 * @return  array	The options or
 *		  boolean  false in case of an error.
 *
 * @author  rabus
 */
function PMA_getEnumSetOptions($type_def)
{
	$open = strpos($type_def, '(');
	$close = strrpos($type_def, ')');
	if (!$open || !$close) {
		return false;
	}
	$options = substr($type_def, $open + 2, $close - $open - 3);
	$options = explode('\',\'', $options);
	return $options;
} // end of the 'PMA_getEnumSetOptions' function

/**
 * Writes localised date
 *
 * @param   string   the current timestamp
 *
 * @return  string   the formatted date
 *
 * @access  public
 */
function PMA_localisedDate($timestamp = -1, $format = '')
{
	global $datefmt, $month, $day_of_week;

	if ($format == '') {
		$format = $datefmt;
	}

	if ($timestamp == -1) {
		$timestamp = time();
	}

	$date = preg_replace('@%[aA]@', $day_of_week[(int)strftime('%w', $timestamp)], $format);
	$date = preg_replace('@%[bB]@', $month[(int)strftime('%m', $timestamp)-1], $date);

	return strftime($date, $timestamp);
} // end of the 'PMA_localisedDate()' function


/**
 * returns a tab for tabbed navigation.
 * If the variables $link and $args ar left empty, an inactive tab is created
 *
 * @uses	$GLOBALS['PMA_PHP_SELF']
 * @uses	$GLOBALS['strEmpty']
 * @uses	$GLOBALS['strDrop']
 * @uses	$GLOBALS['active_page']
 * @uses	$GLOBALS['url_query']
 * @uses	$cfg['MainPageIconic']
 * @uses	$GLOBALS['pmaThemeImage']
 * @uses	PMA_generate_common_url()
 * @uses	E_USER_NOTICE
 * @uses	htmlentities()
 * @uses	urlencode()
 * @uses	sprintf()
 * @uses	trigger_error()
 * @uses	array_merge()
 * @uses	basename()
 * @param   array   $tab	array with all options
 * @return  string  html code for one tab, a link if valid otherwise a span
 * @access  public
 */
function PMA_getTab($tab)
{
	// default values
	$defaults = array(
		'text'	  => '',
		'class'	 => '',
		'active'	=> false,
		'link'	  => '',
		'sep'	   => '?',
		'attr'	  => '',
		'args'	  => '',
		'warning'   => '',
		'fragment'  => '',
	);

	$tab = array_merge($defaults, $tab);

	// determine additionnal style-class
	if (empty($tab['class'])) {
		if ($tab['text'] == $GLOBALS['strEmpty']
			|| $tab['text'] == $GLOBALS['strDrop']) {
			$tab['class'] = 'caution';
		} elseif (!empty($tab['active'])
		  || (isset($GLOBALS['active_page'])
			   && $GLOBALS['active_page'] == $tab['link'])
		  || (basename($GLOBALS['PMA_PHP_SELF']) == $tab['link'] && empty($tab['warning'])))
		{
			$tab['class'] = 'active';
		}
	}

	if (!empty($tab['warning'])) {
		$tab['class'] .= ' warning';
		$tab['attr'] .= ' title="' . htmlspecialchars($tab['warning']) . '"';
	}

	// build the link
	if (!empty($tab['link'])) {
		$tab['link'] = htmlentities($tab['link']);
		$tab['link'] = $tab['link'] . $tab['sep']
			.(empty($GLOBALS['url_query']) ?
				PMA_generate_common_url() : $GLOBALS['url_query']);
		if (!empty($tab['args'])) {
			foreach ($tab['args'] as $param => $value) {
				$tab['link'] .= '&amp;' . urlencode($param) . '='
					. urlencode($value);
			}
		}
	}

	if (! empty($tab['fragment'])) {
		$tab['link'] .= $tab['fragment'];
	}

	// display icon, even if iconic is disabled but the link-text is missing
	if (($GLOBALS['cfg']['MainPageIconic'] || empty($tab['text']))
		&& isset($tab['icon'])) {
		// avoid generating an alt tag, because it only illustrates
		// the text that follows and if browser does not display
		// images, the text is duplicated
		$image = '<img class="icon" src="' . htmlentities($GLOBALS['pmaThemeImage'])
			.'%1$s" width="16" height="16" alt="" />%2$s';
		$tab['text'] = sprintf($image, htmlentities($tab['icon']), $tab['text']);
	}
	// check to not display an empty link-text
	elseif (empty($tab['text'])) {
		$tab['text'] = '?';
		trigger_error('empty linktext in function ' . __FUNCTION__ . '()',
			E_USER_NOTICE);
	}

	$out = '<li' . ($tab['class'] == 'active' ? ' class="active"' : '') . '>';

	if (!empty($tab['link'])) {
		$out .= '<a class="tab' . htmlentities($tab['class']) . '"'
			.' href="' . $tab['link'] . '" ' . $tab['attr'] . '>'
			. $tab['text'] . '</a>';
	} else {
		$out .= '<span class="tab' . htmlentities($tab['class']) . '">'
			. $tab['text'] . '</span>';
	}

	$out .= '</li>';
	return $out;
} // end of the 'PMA_getTab()' function

/**
 * returns html-code for a tab navigation
 *
 * @uses	PMA_getTab()
 * @uses	htmlentities()
 * @param   array   $tabs   one element per tab
 * @param   string  $tag_id id used for the html-tag
 * @return  string  html-code for tab-navigation
 */
function PMA_getTabs($tabs, $tag_id = 'topmenu')
{
	$tab_navigation =
		 '<div id="' . htmlentities($tag_id) . 'container">' . "\n"
		.'<ul id="' . htmlentities($tag_id) . '">' . "\n";

	foreach ($tabs as $tab) {
		$tab_navigation .= PMA_getTab($tab) . "\n";
	}

	$tab_navigation .=
		 '</ul>' . "\n"
		.'<div class="clearfloat"></div>'
		.'</div>' . "\n";

	return $tab_navigation;
}


/**
 * Displays a link, or a button if the link's URL is too large, to
 * accommodate some browsers' limitations
 *
 * @param  string  the URL
 * @param  string  the link message
 * @param  mixed   $tag_params  string: js confirmation
 *							  array: additional tag params (f.e. style="")
 * @param  boolean $new_form	we set this to false when we are already in
 *							  a  form, to avoid generating nested forms
 *
 * @return string  the results to be echoed or saved in an array
 */
function PMA_linkOrButton($url, $message, $tag_params = array(),
	$new_form = true, $strip_img = false, $target = '')
{
	if (! is_array($tag_params)) {
		$tmp = $tag_params;
		$tag_params = array();
		if (!empty($tmp)) {
			$tag_params['onclick'] = 'return confirmLink(this, \'' . $tmp . '\')';
		}
		unset($tmp);
	}
	if (! empty($target)) {
		$tag_params['target'] = htmlentities($target);
	}

	$tag_params_strings = array();
	foreach ($tag_params as $par_name => $par_value) {
		// htmlspecialchars() only on non javascript
		$par_value = substr($par_name, 0, 2) == 'on'
			? $par_value
			: htmlspecialchars($par_value);
		$tag_params_strings[] = $par_name . '="' . $par_value . '"';
	}

	// previously the limit was set to 2047, it seems 1000 is better
	if (strlen($url) <= 1000) {
		// no whitespace within an <a> else Safari will make it part of the link
		$ret = "\n" . '<a href="' . $url . '" '
			. implode(' ', $tag_params_strings) . '>'
			. $message . '</a>' . "\n";
	} else {
		// no spaces (linebreaks) at all
		// or after the hidden fields
		// IE will display them all

		// add class=link to submit button
		if (empty($tag_params['class'])) {
			$tag_params['class'] = 'link';
		}

		// decode encoded url separators
		$separator   = PMA_get_arg_separator();
		// on most places separator is still hard coded ...
		if ($separator !== '&') {
			// ... so always replace & with $separator
			$url		 = str_replace(htmlentities('&'), $separator, $url);
			$url		 = str_replace('&', $separator, $url);
		}
		$url		 = str_replace(htmlentities($separator), $separator, $url);
		// end decode

		$url_parts   = parse_url($url);
		$query_parts = explode($separator, $url_parts['query']);
		if ($new_form) {
			$ret = '<form action="' . $url_parts['path'] . '" class="link"'
				 . ' method="post"' . $target . ' style="display: inline;">';
			$subname_open   = '';
			$subname_close  = '';
			$submit_name	= '';
		} else {
			$query_parts[] = 'redirect=' . $url_parts['path'];
			if (empty($GLOBALS['subform_counter'])) {
				$GLOBALS['subform_counter'] = 0;
			}
			$GLOBALS['subform_counter']++;
			$ret			= '';
			$subname_open   = 'subform[' . $GLOBALS['subform_counter'] . '][';
			$subname_close  = ']';
			$submit_name	= ' name="usesubform[' . $GLOBALS['subform_counter'] . ']"';
		}
		foreach ($query_parts as $query_pair) {
			list($eachvar, $eachval) = explode('=', $query_pair);
			$ret .= '<input type="hidden" name="' . $subname_open . $eachvar
				. $subname_close . '" value="'
				. htmlspecialchars(urldecode($eachval)) . '" />';
		} // end while

		if (stristr($message, '<img')) {
			if ($strip_img) {
				$message = trim(strip_tags($message));
				$ret .= '<input type="submit"' . $submit_name . ' '
					. implode(' ', $tag_params_strings)
					. ' value="' . htmlspecialchars($message) . '" />';
			} else {
				$ret .= '<input type="image"' . $submit_name . ' '
					. implode(' ', $tag_params_strings)
					. ' src="' . preg_replace(
						'/^.*\ssrc="([^"]*)".*$/si', '\1', $message) . '"'
					. ' value="' . htmlspecialchars(
						preg_replace('/^.*\salt="([^"]*)".*$/si', '\1',
							$message))
					. '" />';
			}
		} else {
			$message = trim(strip_tags($message));
			$ret .= '<input type="submit"' . $submit_name . ' '
				. implode(' ', $tag_params_strings)
				. ' value="' . htmlspecialchars($message) . '" />';
		}
		if ($new_form) {
			$ret .= '</form>';
		}
	} // end if... else...

		return $ret;
} // end of the 'PMA_linkOrButton()' function


/**
 * Returns a given timespan value in a readable format.
 *
 * @uses	$GLOBALS['timespanfmt']
 * @uses	sprintf()
 * @uses	floor()
 * @param  int	 the timespan
 *
 * @return string  the formatted value
 */
function PMA_timespanFormat($seconds)
{
	$return_string = '';
	$days = floor($seconds / 86400);
	if ($days > 0) {
		$seconds -= $days * 86400;
	}
	$hours = floor($seconds / 3600);
	if ($days > 0 || $hours > 0) {
		$seconds -= $hours * 3600;
	}
	$minutes = floor($seconds / 60);
	if ($days > 0 || $hours > 0 || $minutes > 0) {
		$seconds -= $minutes * 60;
	}
	return sprintf($GLOBALS['timespanfmt'], (string)$days, (string)$hours, (string)$minutes, (string)$seconds);
}

/**
 * Takes a string and outputs each character on a line for itself. Used
 * mainly for horizontalflipped display mode.
 * Takes care of special html-characters.
 * Fulfills todo-item
 * http://sf.net/tracker/?func=detail&aid=544361&group_id=23067&atid=377411
 *
 * @todo	add a multibyte safe function PMA_STR_split()
 * @uses	strlen
 * @param   string   The string
 * @param   string   The Separator (defaults to "<br />\n")
 *
 * @access  public
 * @author  Garvin Hicking <me@supergarv.de>
 * @return  string	  The flipped string
 */
function PMA_flipstring($string, $Separator = "<br />\n")
{
	$format_string = '';
	$charbuff = false;

	for ($i = 0; $i < strlen($string); $i++) {
		$char = $string{$i};
		$append = false;

		if ($char == '&') {
			$format_string .= $charbuff;
			$charbuff = $char;
			$append = true;
		} elseif (!empty($charbuff)) {
			$charbuff .= $char;
		} elseif ($char == ';' && !empty($charbuff)) {
			$format_string .= $charbuff;
			$charbuff = false;
			$append = true;
		} else {
			$format_string .= $char;
			$append = true;
		}

		if ($append && ($i != strlen($string))) {
			$format_string .= $Separator;
		}
	}

	return $format_string;
}


/**
 * Function added to avoid path disclosures.
 * Called by each script that needs parameters, it displays
 * an error message and, by default, stops the execution.
 *
 * Not sure we could use a strMissingParameter message here,
 * would have to check if the error message file is always available
 *
 * @todo	localize error message
 * @todo	use PMA_fatalError() if $die === true?
 * @uses	PMA_getenv()
 * @uses	header_meta_style.inc.php
 * @uses	$GLOBALS['PMA_PHP_SELF']
 * basename
 * @param   array   The names of the parameters needed by the calling
 *				  script.
 * @param   boolean Stop the execution?
 *				  (Set this manually to false in the calling script
 *				   until you know all needed parameters to check).
 * @param   boolean Whether to include this list in checking for special params.
 * @global  string  path to current script
 * @global  boolean flag whether any special variable was required
 *
 * @access  public
 * @author  Marc Delisle (lem9@users.sourceforge.net)
 */
function PMA_checkParameters($params, $die = true, $request = true)
{
	global $checked_special;

	if (!isset($checked_special)) {
		$checked_special = false;
	}

	$reported_script_name = basename($GLOBALS['PMA_PHP_SELF']);
	$found_error = false;
	$error_message = '';

	foreach ($params as $param) {
		if ($request && $param != 'db' && $param != 'table') {
			$checked_special = true;
		}

		if (!isset($GLOBALS[$param])) {
			$error_message .= $reported_script_name
				. ': Missing parameter: ' . $param
				. ' <a href="./Documentation.html#faqmissingparameters"'
				. ' target="documentation"> (FAQ 2.8)</a><br />';
			$found_error = true;
		}
	}
	if ($found_error) {
		/**
		 * display html meta tags
		 */
		require_once './libraries/header_meta_style.inc.php';
		echo '</head><body><p>' . $error_message . '</p></body></html>';
		if ($die) {
			exit();
		}
	}
} // end function

/**
 * Function to generate unique condition for specified row.
 *
 * @uses	PMA_MYSQL_INT_VERSION
 * @uses	$GLOBALS['analyzed_sql'][0]
 * @uses	PMA_DBI_field_flags()
 * @uses	PMA_backquote()
 * @uses	PMA_sqlAddslashes()
 * @uses	stristr()
 * @uses	bin2hex()
 * @uses	preg_replace()
 * @param   resource	$handle		 current query result
 * @param   integer	 $fields_cnt	 number of fields
 * @param   array	   $fields_meta	meta information about fields
 * @param   array	   $row			current row
 * @param   boolean	 $force_unique   generate condition only on pk or unique
 *
 * @access  public
 * @author  Michal Cihar (michal@cihar.com) and others...
 * @return  string	  calculated condition
 */
function PMA_getUniqueCondition($handle, $fields_cnt, $fields_meta, $row, $force_unique=false)
{
	$primary_key		  = '';
	$unique_key		   = '';
	$nonprimary_condition = '';
	$preferred_condition = '';

	for ($i = 0; $i < $fields_cnt; ++$i) {
		$condition   = '';
		$field_flags = PMA_DBI_field_flags($handle, $i);
		$meta		= $fields_meta[$i];

		// do not use a column alias in a condition
		if (! isset($meta->orgname) || ! strlen($meta->orgname)) {
			$meta->orgname = $meta->name;

			if (isset($GLOBALS['analyzed_sql'][0]['select_expr'])
			  && is_array($GLOBALS['analyzed_sql'][0]['select_expr'])) {
				foreach ($GLOBALS['analyzed_sql'][0]['select_expr']
				  as $select_expr) {
					// need (string) === (string)
					// '' !== 0 but '' == 0
					if ((string) $select_expr['alias'] === (string) $meta->name) {
						$meta->orgname = $select_expr['column'];
						break;
					} // end if
				} // end foreach
			}
		}

		// Do not use a table alias in a condition.
		// Test case is:
		// select * from galerie x WHERE
		//(select count(*) from galerie y where y.datum=x.datum)>1 
		//
		// But orgtable is present only with mysqli extension so the
		// fix is only for mysqli.
		if (isset($meta->orgtable) && $meta->table != $meta->orgtable) {
			$meta->table = $meta->orgtable;
		}

		// to fix the bug where float fields (primary or not)
		// can't be matched because of the imprecision of
		// floating comparison, use CONCAT
		// (also, the syntax "CONCAT(field) IS NULL"
		// that we need on the next "if" will work)
		if ($meta->type == 'real') {
			$condition = ' CONCAT(' . PMA_backquote($meta->table) . '.'
				. PMA_backquote($meta->orgname) . ') ';
		} else {
			// string and blob fields have to be converted using
			// the system character set (always utf8) since
			// mysql4.1 can use different charset for fields.
			if (PMA_MYSQL_INT_VERSION >= 40100
			  && ($meta->type == 'string' || $meta->type == 'blob')) {
				$condition = ' CONVERT(' . PMA_backquote($meta->table) . '.'
					. PMA_backquote($meta->orgname) . ' USING utf8) ';
			} else {
				$condition = ' ' . PMA_backquote($meta->table) . '.'
					. PMA_backquote($meta->orgname) . ' ';
			}
		} // end if... else...

		if (!isset($row[$i]) || is_null($row[$i])) {
			$condition .= 'IS NULL AND';
		} else {
			// timestamp is numeric on some MySQL 4.1
			if ($meta->numeric && $meta->type != 'timestamp') {
				$condition .= '= ' . $row[$i] . ' AND';
			} elseif (($meta->type == 'blob' || $meta->type == 'string')
				// hexify only if this is a true not empty BLOB or a BINARY
				 && stristr($field_flags, 'BINARY')
				 && !empty($row[$i])) {
					// do not waste memory building a too big condition
					if (strlen($row[$i]) < 1000) {
						if (PMA_MYSQL_INT_VERSION < 40002) {
							$condition .= 'LIKE 0x' . bin2hex($row[$i]) . ' AND';
						} else {
							// use a CAST if possible, to avoid problems
							// if the field contains wildcard characters % or _
							$condition .= '= CAST(0x' . bin2hex($row[$i])
								. ' AS BINARY) AND';
						}
					} else {
						// this blob won't be part of the final condition
						$condition = '';
					}
			} else {
				$condition .= '= \''
					. PMA_sqlAddslashes($row[$i], false, true) . '\' AND';
			}
		}
		if ($meta->primary_key > 0) {
			$primary_key .= $condition;
		} elseif ($meta->unique_key > 0) {
			$unique_key  .= $condition;
		}
		$nonprimary_condition .= $condition;
	} // end for

	// Correction University of Virginia 19991216:
	// prefer primary or unique keys for condition,
	// but use conjunction of all values if no primary key
	if ($primary_key) {
		$preferred_condition = $primary_key;
	} elseif ($unique_key) {
		$preferred_condition = $unique_key;
	} elseif (! $force_unique) {
		$preferred_condition = $nonprimary_condition;
	}

	return preg_replace('|\s?AND$|', '', $preferred_condition);
} // end function

/**
 * Generate a button or image tag
 *
 * @uses	PMA_USR_BROWSER_AGENT
 * @uses	$GLOBALS['pmaThemeImage']
 * @uses	$GLOBALS['cfg']['PropertiesIconic']
 * @param   string	  name of button element
 * @param   string	  class of button element
 * @param   string	  name of image element
 * @param   string	  text to display
 * @param   string	  image to display
 *
 * @access  public
 * @author  Michal Cihar (michal@cihar.com)
 */
function PMA_buttonOrImage($button_name, $button_class, $image_name, $text,
	$image)
{
	/* Opera has trouble with <input type="image"> */
	/* IE has trouble with <button> */
	if (PMA_USR_BROWSER_AGENT != 'IE') {
		echo '<button class="' . $button_class . '" type="submit"'
			.' name="' . $button_name . '" value="' . $text . '"'
			.' title="' . $text . '">' . "\n"
			.'<img class="icon" src="' . $GLOBALS['pmaThemeImage'] . $image . '"'
			.' title="' . $text . '" alt="' . $text . '" width="16"'
			.' height="16" />'
			.($GLOBALS['cfg']['PropertiesIconic'] === 'both' ? '&nbsp;' . $text : '') . "\n"
			.'</button>' . "\n";
	} else {
		echo '<input type="image" name="' . $image_name . '" value="'
			. $text . '" title="' . $text . '" src="' . $GLOBALS['pmaThemeImage']
			. $image . '" />'
			. ($GLOBALS['cfg']['PropertiesIconic'] === 'both' ? '&nbsp;' . $text : '') . "\n";
	}
} // end function

/**
 * Generate a pagination selector for browsing resultsets
 *
 * @uses	$GLOBALS['strPageNumber']
 * @uses	range()
 * @param   string	  URL for the JavaScript
 * @param   string	  Number of rows in the pagination set
 * @param   string	  current page number
 * @param   string	  number of total pages
 * @param   string	  If the number of pages is lower than this
 *					  variable, no pages will be ommitted in
 *					  pagination
 * @param   string	  How many rows at the beginning should always
 *					  be shown?
 * @param   string	  How many rows at the end should always
 *					  be shown?
 * @param   string	  Percentage of calculation page offsets to
 *					  hop to a next page
 * @param   string	  Near the current page, how many pages should
 *					  be considered "nearby" and displayed as
 *					  well?
 * @param   string	  The prompt to display (sometimes empty)
 *
 * @access  public
 * @author  Garvin Hicking (pma@supergarv.de)
 */
function PMA_pageselector($url, $rows, $pageNow = 1, $nbTotalPage = 1,
	$showAll = 200, $sliceStart = 5, $sliceEnd = 5, $percent = 20,
	$range = 10, $prompt = '')
{
	$gotopage = $prompt
			  . ' <select name="pos" onchange="goToUrl(this, \''
			  . $url . '\');">' . "\n";
	if ($nbTotalPage < $showAll) {
		$pages = range(1, $nbTotalPage);
	} else {
		$pages = array();

		// Always show first X pages
		for ($i = 1; $i <= $sliceStart; $i++) {
			$pages[] = $i;
		}

		// Always show last X pages
		for ($i = $nbTotalPage - $sliceEnd; $i <= $nbTotalPage; $i++) {
			$pages[] = $i;
		}

		// garvin: Based on the number of results we add the specified
		// $percent percentate to each page number,
		// so that we have a representing page number every now and then to
		// immideately jump to specific pages.
		// As soon as we get near our currently chosen page ($pageNow -
		// $range), every page number will be
		// shown.
		$i = $sliceStart;
		$x = $nbTotalPage - $sliceEnd;
		$met_boundary = false;
		while ($i <= $x) {
			if ($i >= ($pageNow - $range) && $i <= ($pageNow + $range)) {
				// If our pageselector comes near the current page, we use 1
				// counter increments
				$i++;
				$met_boundary = true;
			} else {
				// We add the percentate increment to our current page to
				// hop to the next one in range
				$i = $i + floor($nbTotalPage / $percent);

				// Make sure that we do not cross our boundaries.
				if ($i > ($pageNow - $range) && !$met_boundary) {
					$i = $pageNow - $range;
				}
			}

			if ($i > 0 && $i <= $x) {
				$pages[] = $i;
			}
		}

		// Since because of ellipsing of the current page some numbers may be double,
		// we unify our array:
		sort($pages);
		$pages = array_unique($pages);
	}

	foreach ($pages as $i) {
		if ($i == $pageNow) {
			$selected = 'selected="selected" style="font-weight: bold"';
		} else {
			$selected = '';
		}
		$gotopage .= '				<option ' . $selected . ' value="' . (($i - 1) * $rows) . '">' . $i . '</option>' . "\n";
	}

	$gotopage .= ' </select><noscript><input type="submit" value="' . $GLOBALS['strGo'] . '" /></noscript>';


	return $gotopage;
} // end function


/**
 * Generate navigation for a list
 *
 * @todo	use $pos from $_url_params
 * @uses	$GLOBALS['strPageNumber']
 * @uses	range()
 * @param   integer	 number of elements in the list
 * @param   integer	 current position in the list
 * @param   array	   url parameters
 * @param   string	  script name for form target
 * @param   string	  target frame
 * @param   integer	 maximum number of elements to display from the list
 *
 * @access  public
 */
function PMA_listNavigator($count, $pos, $_url_params, $script, $frame, $max_count) {

	if ($max_count < $count) {
		echo 'frame_navigation' == $frame ? '<div id="navidbpageselector">' . "\n" : '';
		echo $GLOBALS['strPageNumber'];
		echo 'frame_navigation' == $frame ? '<br />' : ' ';

		// Move to the beginning or to the previous page
		if ($pos > 0) {
			// loic1: patch #474210 from Gosha Sakovich - part 1
			if ($GLOBALS['cfg']['NavigationBarIconic']) {
				$caption1 = '&lt;&lt;';
				$caption2 = ' &lt; ';
				$title1   = ' title="' . $GLOBALS['strPos1'] . '"';
				$title2   = ' title="' . $GLOBALS['strPrevious'] . '"';
			} else {
				$caption1 = $GLOBALS['strPos1'] . ' &lt;&lt;';
				$caption2 = $GLOBALS['strPrevious'] . ' &lt;';
				$title1   = '';
				$title2   = '';
			} // end if... else...
			$_url_params['pos'] = 0;
			echo '<a' . $title1 . ' href="' . $script
				. PMA_generate_common_url($_url_params) . '" target="' . $frame . '">'
				. $caption1 . '</a>';
			$_url_params['pos'] = $pos - $max_count;
			echo '<a' . $title2 . ' href="' . $script
				. PMA_generate_common_url($_url_params) . '" target="' . $frame . '">'
				. $caption2 . '</a>';
		}

		echo "\n", '<form action="./', basename($script), '" method="post" target="', $frame, '">', "\n";
		echo PMA_generate_common_hidden_inputs($_url_params);
		echo PMA_pageselector(
			$script . PMA_generate_common_url($_url_params) . '&',
				$max_count,
				floor(($pos + 1) / $max_count) + 1,
				ceil($count / $max_count));
		echo '</form>';

		if ($pos + $max_count < $count) {
			if ($GLOBALS['cfg']['NavigationBarIconic']) {
				$caption3 = ' &gt; ';
				$caption4 = '&gt;&gt;';
				$title3   = ' title="' . $GLOBALS['strNext'] . '"';
				$title4   = ' title="' . $GLOBALS['strEnd'] . '"';
			} else {
				$caption3 = '&gt; ' . $GLOBALS['strNext'];
				$caption4 = '&gt;&gt; ' . $GLOBALS['strEnd'];
				$title3   = '';
				$title4   = '';
			} // end if... else...
			$_url_params['pos'] = $pos + $max_count;
			echo '<a' . $title3 . ' href="' . $script
				. PMA_generate_common_url($_url_params) . '" target="' . $frame . '">'
				. $caption3 . '</a>';
			$_url_params['pos'] = floor($count / $max_count) * $max_count;
			if ($_url_params['pos'] == $count) {
				$_url_params['pos'] = $count - $max_count;
			}
			echo '<a' . $title4 . ' href="' . $script
				. PMA_generate_common_url($_url_params) . '" target="' . $frame . '">'
				. $caption4 . '</a>';
		}
		echo "\n";
		if ('frame_navigation' == $frame) {
			echo '</div>' . "\n";
		}
	}
}

/**
 * replaces %u in given path with current user name
 *
 * example:
 * <code>
 * $user_dir = PMA_userDir('/var/pma_tmp/%u/'); // '/var/pma_tmp/root/'
 *
 * </code>
 * @uses	$cfg['Server']['user']
 * @uses	substr()
 * @uses	str_replace()
 * @param   string  $dir with wildcard for user
 * @return  string  per user directory
 */
function PMA_userDir($dir)
{
	// add trailing slash
	if (substr($dir, -1) != '/') {
		$dir .= '/';
	}

	return str_replace('%u', $GLOBALS['cfg']['Server']['user'], $dir);
}

/**
 * returns html code for db link to default db page
 *
 * @uses	$cfg['DefaultTabDatabase']
 * @uses	$GLOBALS['db']
 * @uses	$GLOBALS['strJumpToDB']
 * @uses	PMA_generate_common_url()
 * @uses	PMA_unescape_mysql_wildcards()
 * @uses	strlen()
 * @uses	sprintf()
 * @uses	htmlspecialchars()
 * @param   string  $database
 * @return  string  html link to default db page
 */
function PMA_getDbLink($database = null)
{
	if (!strlen($database)) {
		if (!strlen($GLOBALS['db'])) {
			return '';
		}
		$database = $GLOBALS['db'];
	} else {
		$database = PMA_unescape_mysql_wildcards($database);
	}

	return '<a href="' . $GLOBALS['cfg']['DefaultTabDatabase'] . '?' . PMA_generate_common_url($database) . '"'
		.' title="' . sprintf($GLOBALS['strJumpToDB'], htmlspecialchars($database)) . '">'
		.htmlspecialchars($database) . '</a>';
}

/**
 * Displays a lightbulb hint explaining a known external bug
 * that affects a functionality
 *
 * @uses	PMA_MYSQL_INT_VERSION
 * @uses	$GLOBALS['strKnownExternalBug']
 * @uses	PMA_showHint()
 * @uses	sprintf()
 * @param   string  $functionality localized message explaining the func.
 * @param   string  $component  'mysql' (eventually, 'php')
 * @param   string  $minimum_version of this component
 * @param   string  $bugref  bug reference for this component
 */
function PMA_externalBug($functionality, $component, $minimum_version, $bugref)
{
	if ($component == 'mysql' && PMA_MYSQL_INT_VERSION < $minimum_version) {
		echo PMA_showHint(sprintf($GLOBALS['strKnownExternalBug'], $functionality, 'http://bugs.mysql.com/' . $bugref));
	}
}

/**
 * Converts a bit value to printable format;
 * in MySQL a BIT field can be from 1 to 64 bits so we need this
 * function because in PHP, decbin() supports only 32 bits
 *
 * @uses	ceil()
 * @uses	decbin()
 * @uses	ord()
 * @uses	substr()
 * @uses	sprintf()
 * @param   numeric $value coming from a BIT field
 * @param   integer $length 
 * @return  string  the printable value 
 */
function PMA_printable_bit_value($value, $length) {
	$printable = '';
	for ($i = 0; $i < ceil($length / 8); $i++) {
		$printable .= sprintf('%08d', decbin(ord(substr($value, $i, 1))));
	}
	$printable = substr($printable, -$length);
	return $printable;
}

/**
 * Extracts the true field type and length from a field type spec
 *
 * @uses	strpos()
 * @uses	chop()
 * @uses	substr()
 * @param   string $fieldspec 
 * @return  array associative array containing the type and length 
 */
function PMA_extract_type_length($fieldspec) {
	$first_bracket_pos = strpos($fieldspec, '(');
	if ($first_bracket_pos) {
		$length = chop(substr($fieldspec, $first_bracket_pos + 1, (strpos($fieldspec, ')') - $first_bracket_pos - 1)));
		$type = chop(substr($fieldspec, 0, $first_bracket_pos));
	} else {
		$type = $fieldspec;
		$length = '';
	}
	return array(
		'type' => $type,
		'length' => $length
	);
}
?>
